Skip to content

Hugo update - #359

Merged
falkmielke merged 14 commits into
masterfrom
hugo_update
Sep 11, 2026
Merged

Hugo update#359
falkmielke merged 14 commits into
masterfrom
hugo_update

Conversation

@falkmielke

@falkmielke falkmielke commented Feb 21, 2025

Copy link
Copy Markdown
Contributor

Description

The Hugo build instructions were a bit dated.
The site would not build locally any more.

ERROR deprecated: site config key paginate was deprecated in Hugo v0.128.0 and subsequently removed. Use pagination.pagerSize instead.
Start building sites …
hugo v0.144.1+extended+withdeploy linux/amd64 BuildDate=unknown

ERROR deprecated: .Site.LastChange was deprecated in Hugo v0.123.0 and subsequently removed. Use .Site.Lastmod instead.

More errors were related to changed partials from the minimo theme.

I have also attempted to update the github actions workflow.

This is the attempt to migrate to the latest versions of hugo and minimo.

@falkmielke

falkmielke commented Feb 21, 2025

Copy link
Copy Markdown
Contributor Author

Tested, seems to work.
Thank you in advance for your review!

falkmielke added a commit that referenced this pull request Feb 21, 2025
@falkmielke
docker: markdown blocks / hugo clash
4c2cdcf 
curly brackets did not go well with the hugo update
#359
@falkmielke

falkmielke commented Mar 12, 2025

Copy link
Copy Markdown
Contributor Author

Update:
I attempted to get full math equation support for quarto documents, and reached out to the quarto discussions for help.

@falkmielke

falkmielke commented Apr 9, 2025

Copy link
Copy Markdown
Contributor Author

Note: I get error messages when trying to hugo server locally (hugo version 0.145.0-3). We should double check to make this future proof.

ERROR deprecated: site config key paginate was deprecated in Hugo v0.128.0 and subsequently removed. Use pagination.pagerSize instead.
Watching for changes in /data/git/tutorials_pr/{content,data,layouts,package.json,static,themes}
Watching for config changes in /data/git/tutorials_pr/config.toml
Start building sites …
hugo v0.145.0+extended+withdeploy linux/amd64 BuildDate=unknown

ERROR deprecated: .Site.LastChange was deprecated in Hugo v0.123.0 and subsequently removed. Use .Site.Lastmod instead.
ERROR render of "/data/git/tutorials_pr/content/articles/_index.md" failed: "/data/git/tutorials_pr/themes/minimo/layouts/_default/list.html:1:3": execute of template failed: template: _default/list.html:1:3: executing "_default/list.html" at <partial "header" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/header.html:4:4": execute of template failed: template: partials/header.html:4:4: executing "partials/header.html" at <partial "head/head" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/head.html:9:5": execute of template failed: template: partials/head/head.html:9:5: executing "partials/head/head.html" at <partial "head/includes" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/includes.html:14:4": execute of template failed: template: partials/head/includes.html:14:4: executing "partials/head/includes.html" at <partial "head/analytics" .>: error calling partial: execute of template failed: html/template:partials/head/analytics.html:1:13: no such template "_internal/google_analytics_async.html"
ERROR render of "/data/git/tutorials_pr/content/_index.md" failed: "/data/git/tutorials_pr/themes/minimo/layouts/index.html:1:3": execute of template failed: template: index.html:1:3: executing "index.html" at <partial "header" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/header.html:4:4": execute of template failed: template: partials/header.html:4:4: executing "partials/header.html" at <partial "head/head" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/head.html:9:5": execute of template failed: template: partials/head/head.html:9:5: executing "partials/head/head.html" at <partial "head/includes" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/includes.html:14:4": execute of template failed: template: partials/head/includes.html:14:4: executing "partials/head/includes.html" at <partial "head/analytics" .>: error calling partial: execute of template failed: html/template:partials/head/analytics.html:1:13: no such template "_internal/google_analytics_async.html"
ERROR render of "/404" failed: "/data/git/tutorials_pr/themes/minimo/layouts/404.html:1:3": execute of template failed: template: 404.html:1:3: executing "404.html" at <partial "header" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/header.html:4:4": execute of template failed: template: partials/header.html:4:4: executing "partials/header.html" at <partial "head/head" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/head.html:9:5": execute of template failed: template: partials/head/head.html:9:5: executing "partials/head/head.html" at <partial "head/includes" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/includes.html:14:4": execute of template failed: template: partials/head/includes.html:14:4: executing "partials/head/includes.html" at <partial "head/analytics" .>: error calling partial: execute of template failed: html/template:partials/head/analytics.html:1:13: no such template "_internal/google_analytics_async.html"
ERROR render of "/data/git/tutorials_pr/content/articles/computing/index.md" failed: "/data/git/tutorials_pr/themes/minimo/layouts/_default/single.html:1:3": execute of template failed: template: _default/single.html:1:3: executing "_default/single.html" at <partial "header" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/header.html:4:4": execute of template failed: template: partials/header.html:4:4: executing "partials/header.html" at <partial "head/head" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/head.html:9:5": execute of template failed: template: partials/head/head.html:9:5: executing "partials/head/head.html" at <partial "head/includes" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/includes.html:14:4": execute of template failed: template: partials/head/includes.html:14:4: executing "partials/head/includes.html" at <partial "head/analytics" .>: error calling partial: execute of template failed: html/template:partials/head/analytics.html:1:13: no such template "_internal/google_analytics_async.html"
Built in 76 ms
Error: error building site: render: failed to render pages: render of "/data/git/tutorials_pr/content/articles/skills/index.md" failed: "/data/git/tutorials_pr/themes/minimo/layouts/_default/single.html:1:3": execute of template failed: template: _default/single.html:1:3: executing "_default/single.html" at <partial "header" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/header.html:4:4": execute of template failed: template: partials/header.html:4:4: executing "partials/header.html" at <partial "head/head" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/head.html:9:5": execute of template failed: template: partials/head/head.html:9:5: executing "partials/head/head.html" at <partial "head/includes" .>: error calling partial: "/data/git/tutorials_pr/themes/minimo/layouts/partials/head/includes.html:14:4": execute of template failed: template: partials/head/includes.html:14:4: executing "partials/head/includes.html" at <partial "head/analytics" .>: error calling partial: execute of template failed: html/template:partials/head/analytics.html:1:13: no such template "_internal/google_analytics_async.html"

@falkmielke falkmielke mentioned this pull request May 19, 2026
Merged
@falkmielke

falkmielke commented May 26, 2026

Copy link
Copy Markdown
Contributor Author

There is still a major issue to be discussed with maintainers:
the minimo theme seems unmaintained;
a fork is available with a branch that holds changes to reach the latest version.
https://github.com/falkmielke/minimo/tree/update_202605

Sidenote: I also removed our twitter link.

Related Issue

Loosely related to PR #375 which was merged in here; hugo_update should be merged only after GHA_update.

TODOs before merging:

  • decide on how to proceed with the theme
  • update <tutorials>/.github/workflows/deploy-gh-pages.yml and <tutorials>/.github/workflows/generate-artifact-pr.yml as follows:
      - name: Checkout (theme)
        uses: actions/checkout@v6
        with:
          repository: ????/minimo # ***
          ref: update_202605 # ***
          path: themes/minimo

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@32c7754570a8edd0ae33352fae4a8448f23858e9 #v3.1.0
        with:
          hugo-version: '0.161.1' # ***
          # extended: true

@falkmielke
Merge branch 'master' into hugo_update
03f663d
@falkmielke
hugo_update: locally fix minimo deprecations
0fb489f 
The `minimo` theme seems unmaintained; at least it still contains
deprecated hugo syntax.
This is fixed by selectively copying affected files
  from the `themes/minimo/<...>` subfolders
  to the main hugo folder.

Those files are now under our maintenance and may be
  removed in the future if `minimo` receives and update.
@falkmielke
hugo_update: link latest actions(*)
2fcacd4 
- actions/checkout v7.0.1
- actions/upload-artifact v7.0.1
- c-hive/gha-remove-artifacts v1.8.0
- peaceiris/actions-hugo v3.2.1
- JamesIves/github-pages-deploy-action v4.9.0

... and decided to revert to the official `minimo` repo instead of my
own fork (modifications now live directly in this repo, see previous
commit).
@falkmielke

falkmielke commented Sep 9, 2026

Copy link
Copy Markdown
Contributor Author

@damianooldoni I just fast-forwarded everything to the latest versions again:

  • hugo v165.0
  • all GHA updated with latests commit hashes -> was necessary to test latest hugo in GHA(*)
  • minimo theme is deprecated -> had to bring in files from the theme and update within this repo

Creation of the artifact works, so I assume that website deployment should also work upon merge to master.

(*) Because I included the GHA, this PR now effectively overwrites #375 and the other PR may be closed. Sorry for this; I only realized afterwards that I was working on the same files as @ElsLommelen . Please double check, but I think we can safely close #375 after merging #359 .

If anything is unclear from my writing, please do not hesitate to PM me.
Thank you in advance!

damianooldoni
damianooldoni approved these changes Sep 11, 2026
View reviewed changes

@damianooldoni damianooldoni left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @falkmielke! Thanks for this update.
I tested locally on my Windows machine and everything looks fine 🥳

I just want to share a small config detail not mentioned in the README I had to change in order to render the website locally.
I installed Go and Hugo (last time I rendered the website was on another laptop): so, I am using hugo v0.166.0 and Go v1.27.1.
I needed to replace {{ template "_internal/google_analytics_async.html" . }} in themes/minimo/layouts/partials/head/analytics.html with {{ template "_internal/google_analytics.html" . }} to solve the error:

ERROR html/template:_partials/head/analytics.html:1:13: no such template "_internal/google_analytics_async.html"

I wonder if you had to do this as well. Notice that this ignored as it is just used for local rendering to "simulate" the rendering process on GitHub Pages.

@falkmielke falkmielke mentioned this pull request Sep 11, 2026
Open
@falkmielke

falkmielke commented Sep 11, 2026

Copy link
Copy Markdown
Contributor Author

Thank you for testing, @damianooldoni !

I needed to replace {{ template "_internal/google_analytics_async.html" . }} in themes/minimo/layouts/partials/head/analytics.html with {{ template "_internal/google_analytics.html" . }} to solve

ERROR html/template:_partials/head/analytics.html:1:13: no such template "_internal/google_analytics_async.html"

Interesting. I did not have to change this.
For the moment, I will wrap up this PR, but leave your observation as #381 .

@falkmielke

falkmielke commented Sep 11, 2026

Copy link
Copy Markdown
Contributor Author

For reference, follow-up on the open checkbox points above:

decide on how to proceed with the theme

The theme was temporarily replaced by a fork, but I lack capacity to maintain that. For the moment, I decided to revert, linking to minimo directly, but masking files with deprecated elements with files in this repo.

update /.github/workflows/deploy-gh-pages.yml and /.github/workflows/generate-artifact-pr.yml

These were updated, using immutable commit hashes, and will require more regular updates in the future.

@falkmielke
falkmielke merged commit 9b57421 into master Sep 11, 2026
1 check passed
@falkmielke
falkmielke deleted the hugo_update branch September 11, 2026 10:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@damianooldoni damianooldoni damianooldoni approved these changes
@ThierryO ThierryO Awaiting requested review from ThierryO
@florisvdh florisvdh Awaiting requested review from florisvdh

Assignees

No one assigned

Labels

help wanted

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@falkmielke @damianooldoni @bserrien @ElsLommelen